home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / il_c / ilFSpectImg.z / ilFSpectImg
Encoding:
Text File  |  2002-10-03  |  10.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4. iiiillllFFFFSSSSppppeeeeccccttttIIIImmmmgggg((((3333))))     IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiillllFFFFSSSSppppeeeeccccttttIIIImmmmgggg((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiillllFFFFSSSSppppeeeeccccttttIIIImmmmgggg - compute the spectrum of a fourier domain image
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      ilLink : ilImage : ilCacheImg : ilMemCacheImg : ilOpImg : ilMonadicImg
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <il/ilCdefs.h>
  16.  
  17. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      iiiillllFFFFSSSSppppeeeeccccttttIIIImmmmgggg() computes the spectrum of a complex fourier domain image. It
  19.      is publicly derived from ilMonadicImg and is one of the Fourier
  20.      operators.  The computation is the same as that performed in ilFMagImg(),
  21.      but the difference is in the size and origin of the output. The size of
  22.      the output is the same as the size of the original image and its origin
  23.      is at its center.
  24.  
  25.      All four quadrants are represented. Since this represents the fourier
  26.      transform of a real image, the magnitude or spectrum is conjugate
  27.      symmetric.  Conjugate symmetric means that quadrant 2 is a reflection of
  28.      quadrant 0 and quadrant 1 is a reflection of quadrant 3.
  29.  
  30.      iiiillllFFFFSSSSppppeeeeccccttttIIIImmmmgggg() is more suited for display, while ilFMagImg() might be more
  31.      suitable for frequency domain computation. Both require scaling of the
  32.      spectral values to suit the display, which can be done using
  33.      ilHistScaleImg().
  34.  
  35.      In this class, the pagesize is set equal to the size of the source image.
  36.      So the cache needs to be big enough to hold the entire image. For
  37.      multichanneled images, the cache needs to be big enough to hold just one
  38.      channel, since the spectrum is computed one channel at a time.
  39.  
  40.      The source image for this operator should have the same format as that
  41.      produced by a forward 2D-FFT.
  42.  
  43. CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
  44.      CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr
  45.  
  46.           ilFSpectImg *ilFSpectImgCreate(ilImage *src)
  47.  
  48.  
  49. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  50.      iiiillllFFFFSSSSppppeeeeccccttttIIIImmmmgggg(((())))
  51.  
  52.           ilFSpectImg *ilFSpectImgCreate(ilImage *src)
  53.  
  54.  
  55.           Constructor for this class. _s_r_c is the source image whose spectrum
  56.           is to be computed.  _s_r_c should have the same format as that produced
  57.           by a forward 2D-FFT.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiillllFFFFSSSSppppeeeeccccttttIIIImmmmgggg((((3333))))     IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiillllFFFFSSSSppppeeeeccccttttIIIImmmmgggg((((3333))))
  71.  
  72.  
  73.  
  74. IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  75.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllMMMMoooonnnnaaaaddddiiiiccccIIIImmmmgggg
  76.      ilMondadicImgGetOffset(), ilMondadicImgSetOffset()
  77.  
  78.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllOOOOppppIIIImmmmgggg
  79.      ilOpImgClearClamp(), ilOpImgGetBias(), ilOpImgGetClamp(),
  80.      ilOpImgGetValidOrders(), ilOpImgGetValidTypes(), ilOpImgIsClamped(),
  81.      ilOpImgIsPrecisionKept(), ilOpImgKeepPrecision(), ilOpImgSetBias(),
  82.      ilOpImgSetClampMinMax(), ilOpImgSetClamp()
  83.  
  84.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllMMMMeeeemmmmCCCCaaaacccchhhheeeeIIIImmmmgggg
  85.      ilMemCacheImgEnableMP(), ilMemCacheImgGetPageTime(),
  86.      ilMemCacheImgGetRetainMode(), ilMemCacheImgGetThrashMode(),
  87.      ilMemCacheImgGetThrashTime(), ilMemCacheImgGetTotalPageTime(),
  88.      ilMemCacheImgIsMPenabled(), ilMemCacheImgSetRetainMode(),
  89.      ilMemCacheImgSetThrashMode()
  90.  
  91.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllCCCCaaaacccchhhheeeeIIIImmmmgggg
  92.      ilCacheImgFlush(), ilCacheImgGetCacheSize()
  93.  
  94.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllIIIImmmmaaaaggggeeee
  95.      ilAddInput(), ilAllocFillData(), ilClipTile(), ilClipTileAsTile(),
  96.      ilClipTileFloat(), ilClipTileFloatAsTile(),
  97.      ilConfigureRetainedCacheImage(), ilCopy(), ilCopyTile(), ilCopyTile3D(),
  98.      ilCopyTileCfg(), ilFillTile(), ilFillTile3D(), ilFillTileRGB(),
  99.      ilFreeFillData(), ilGetColorImg(), ilGetColorModel(), ilGetColormap(),
  100.      ilGetColormapPtr(), ilGetCompression(), ilGetConfig(), ilGetCsize(),
  101.      ilGetDataType(), ilGetDimensions(), ilGetDirectInput(),
  102.      ilGetDisplayCacheEnable(), ilGetFill(), ilGetFillData(),
  103.      ilGetFillValue(), ilGetHeight(), ilGetHwEnable(), ilGetHwHint(),
  104.      ilGetHwHintName(), ilGetHwIntHint(), ilGetHwIntHintName(), ilGetInput(),
  105.      ilGetInputTileRequirement(), ilGetLockTileSet(), ilGetMappedPageSize(),
  106.      ilGetMappedSize(), ilGetMaxColormapLevels(), ilGetMaxValue(),
  107.      ilGetMinValue(), ilGetNumChans(), ilGetNumInputs(), ilGetOrder(),
  108.      ilGetOrientation(), ilGetPageBorder(), ilGetPageBorderPtr(),
  109.      ilGetPageBorderX(), ilGetPageBorderY(), ilGetPageBorderZ(),
  110.      ilGetPageCounts(), ilGetPageDelta(), ilGetPageDeltaStruct(),
  111.      ilGetPageDimensions(), ilGetPageIndices(), ilGetPageOrigin(),
  112.      ilGetPageOriginC(), ilGetPageOriginStruct(), ilGetPageOriginX(),
  113.      ilGetPageOriginY(), ilGetPageOriginZ(), ilGetPageSize(),
  114.      ilGetPageSizeBytes(), ilGetPageSizeC(), ilGetPageSizePix(),
  115.      ilGetPageSizeStruct(), ilGetPageSizeVal(), ilGetPageSizeX(),
  116.      ilGetPageSizeXY(), ilGetPageSizeY(), ilGetPageSizeZ(), ilGetPixel(),
  117.      ilGetPixel3D(), ilGetPriority(), ilGetScaleMax(), ilGetScaleMin(),
  118.      ilGetSize(), ilGetSizePtr(), ilGetStrides(), ilGetSubTile(),
  119.      ilGetSubTile3D(), ilGetTile(), ilGetTile3D(), ilGetWidth(), ilGetXsize(),
  120.      ilGetYsize(), ilGetZsize(), ilHasPageBorder(), ilHasPages(),
  121.      ilInitScaleMinMax(), ilIsColorImg(), ilIsIntegral(),
  122.      ilIsMirrorOrientation(), ilIsSigned(), ilIsWritable(), ilLockPage(),
  123.      ilLockPageSet(), ilLockTile(), ilLockTile3D(), ilMapFlipTrans(),
  124.      ilMapFromInput(), ilMapFromInput2D(), ilMapFromInput3D(),
  125.      ilMapFromSource(), ilMapFromSource2D(), ilMapFromSource3D(),
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiillllFFFFSSSSppppeeeeccccttttIIIImmmmgggg((((3333))))     IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiillllFFFFSSSSppppeeeeccccttttIIIImmmmgggg((((3333))))
  137.  
  138.  
  139.  
  140.      ilMapOrientation(), ilMapSize(), ilMapTile(), ilMapTileFlipTrans(),
  141.      ilMapTileFloat(), ilMapToInput(), ilMapToInput2D(), ilMapToInput3D(),
  142.      ilMapToSource(), ilMapToSource2D(), ilMapToSource3D(), ilMapXY(),
  143.      ilMapXYFloat(), ilMapXYSign(), ilQCopyTileCfg(), ilQFillTile3D(),
  144.      ilQFillTileRGB(), ilQGetSubTile3D(), ilQGetTile3D(), ilQLockPageSet(),
  145.      ilQSetSubTile3D(), ilQSetTile3D(), ilRemoveHwHint(),
  146.      ilRemoveHwHintName(), ilRemoveInput(), ilSetColorModel(),
  147.      ilSetColormap(), ilSetCompression(), ilSetCsize(), ilSetDataType(),
  148.      ilSetDisplayCacheEnable(), ilSetFill(), ilSetFillValue(),
  149.      ilSetHwEnable(), ilSetHwHint(), ilSetHwIntHint(), ilSetHwIntHintName(),
  150.      ilSetInput(), ilSetMaxColormapLevels(), ilSetMaxValue(), ilSetMinValue(),
  151.      ilSetNumChans(), ilSetOrder(), ilSetOrientation(), ilSetPageBorder(),
  152.      ilSetPageBorderStruct(), ilSetPageSize(), ilSetPageSizeC(),
  153.      ilSetPageSizeStruct(), ilSetPageSizeXY(), ilSetPageSizeZ(), ilSetPixel(),
  154.      ilSetPixel3D(), ilSetPriority(), ilSetScaleMinMax(), ilSetScaleType(),
  155.      ilSetSize(), ilSetSubTile(), ilSetSubTile3D(), ilSetTile(),
  156.      ilSetTile3D(), ilSetXYsize(), ilSetXsize(), ilSetYsize(), ilSetZsize(),
  157.      ilUnlockPage(), ilUnlockPageSet()
  158.  
  159.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllLLLLiiiinnnnkkkk
  160.      ilLinkClearSet(), ilLinkClearStatus(), ilLinkGetDescription(),
  161.      ilLinkGetDirectParent(), ilLinkGetDisabledIndex(), ilLinkGetFloatProp(),
  162.      ilLinkGetGenerationID(), ilLinkGetIntProp(), ilLinkGetNumChildren(),
  163.      ilLinkGetNumParents(), ilLinkGetParent(), ilLinkGetPtrProp(),
  164.      ilLinkGetRelatedChild(), ilLinkGetRelatedDelete(),
  165.      ilLinkGetRelatedType(), ilLinkGetStatus(), ilLinkIsAllowed(),
  166.      ilLinkIsAltered(), ilLinkIsEnabled(), ilLinkIsRelated(), ilLinkIsSet(),
  167.      ilLinkRemoveParent(), ilLinkRemoveProp(), ilLinkSetDescription(),
  168.      ilLinkSetDisabledIndex(), ilLinkSetEnabled(), ilLinkSetParent(),
  169.      ilLinkSetProp(), ilLinkSetRelatedDelete(), ilLinkSetRelatedType()
  170.  
  171. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  172.      ilRFFTfImg, ilRFFTiImg, ilOpImg, ilMonadicImg
  173.  
  174. NNNNOOOOTTTTEEEESSSS
  175.      The magnitude of a complex number (a + ib) equals sqrt(a*a + b*b).
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.